home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_xemacs.idb / usr / freeware / lib / xemacs-20.4 / info / pcl-cvs.info.z / pcl-cvs.info
Encoding:
GNU Info File  |  1998-05-21  |  57.7 KB  |  1,407 lines
  1. This is Info file ../info/pcl-cvs.info, produced by Makeinfo version
  2. 1.68 from the input file pcl-cvs.texi.
  3.  
  4.    Copyright (C) 1992 Per Cederqvist
  5.  
  6.    Permission is granted to make and distribute verbatim copies of this
  7. manual provided the copyright notice and this permission notice are
  8. preserved on all copies.
  9.  
  10.    Permission is granted to copy and distribute modified versions of
  11. this manual under the conditions for verbatim copying, provided also
  12. that the section entitled "GNU General Public License" is included
  13. exactly as in the original, and provided that the entire resulting
  14. derived work is distributed under the terms of a permission notice
  15. identical to this one.
  16.  
  17.    Permission is granted to copy and distribute translations of this
  18. manual into another language, under the above conditions for modified
  19. versions, except that the section entitled "GNU General Public License"
  20. and this permission notice may be included in translations approved by
  21. the Free Software Foundation instead of in the original English.
  22.  
  23. 
  24. File: pcl-cvs.info,  Node: Top,  Next: Installation,  Prev: (dir),  Up: (dir)
  25.  
  26.    This info manual describes pcl-cvs which is a GNU Emacs front-end to
  27. CVS.  It works with CVS versions 1.5 through 1.7 and newer, and possibly
  28. CVS-1.3 and CVS-1.4A2.  This manual is updated to release 1.05-CVS-1.7
  29. of pcl-cvs.
  30.  
  31. * Menu:
  32.  
  33. * Installation::                How to install pcl-cvs on your system.
  34. * About pcl-cvs::               Authors and ftp sites.
  35.  
  36. * Getting started::             An introduction with a walk-through example.
  37. * Buffer contents::             An explanation of the buffer contents.
  38. * Commands::                    All commands, grouped by type.
  39.  
  40. * Customization::               How you can tailor pcl-cvs to suit your needs.
  41. * Future enhancements::         Future enhancements of pcl-cvs.
  42. * Bugs::                        Bugs (known and unknown).
  43. * COPYING::                     GNU General Public License
  44. * Function and Variable Index::  List of functions and variables.
  45. * Concept Index::               List of concepts.
  46. * Key Index::                   List of keystrokes.
  47.  
  48.  -- The Detailed Node Listing --
  49.  
  50. Installation
  51.  
  52. * Pcl-cvs installation::        How to install pcl-cvs on your system.
  53. * On-line manual installation::  How to install the on-line manual.
  54. * Typeset manual installation::  How to create typeset documentation
  55.                                  about pcl-cvs.
  56.  
  57. About pcl-cvs
  58.  
  59. * Contributors::                Contributors to pcl-cvs.
  60. * Archives::                    Where can I get a copy of Pcl-Cvs?
  61.  
  62. Buffer contents
  63.  
  64. * File status::                 The meaning of the second field.
  65. * Selected files::              How selection works.
  66.  
  67. Commands
  68.  
  69. * Updating the directory::      Commands to update the local directory
  70. * Movement commands::           How to move up and down in the buffer
  71. * Marking files::               How to mark files that other commands
  72.                                 will later operate on.
  73. * Committing changes::          Checking in your modifications to the
  74.                                 CVS repository.
  75. * Editing files::               Loading files into Emacs.
  76. * Getting info about files::    Display the log and status of files.
  77. * Adding and removing files::   Adding and removing files
  78. * Undoing changes::             Undoing changes
  79. * Removing handled entries::    Uninteresting lines can easily be removed.
  80. * Ignoring files::              Telling CVS to ignore generated files.
  81. * Viewing differences::         Commands to `diff' different versions.
  82. * Invoking Ediff::              Running `ediff' from `*cvs*' buffer.
  83. * Invoking Emerge::             Running `emerge' from `*cvs*' buffer.
  84. * Reverting your buffers::      Reverting your buffers
  85. * Miscellaneous commands::      Miscellaneous commands
  86.  
  87. 
  88. File: pcl-cvs.info,  Node: Installation,  Next: About pcl-cvs,  Prev: Top,  Up: Top
  89.  
  90. Installation
  91. ************
  92.  
  93.    This section describes the installation of pcl-cvs, the GNU Emacs CVS
  94. front-end.  You should install not only the elisp files themselves, but
  95. also the on-line documentation so that your users will know how to use
  96. it.  You can create typeset documentation from the file
  97. `pcl-cvs.texinfo' as well as an on-line info file.  The following steps
  98. are also described in the file `INSTALL' in the source directory.
  99.  
  100. * Menu:
  101.  
  102. * Pcl-cvs installation::        How to install pcl-cvs on your system.
  103. * On-line manual installation::  How to install the on-line manual.
  104. * Typeset manual installation::  How to create typeset documentation
  105.                                  about pcl-cvs.
  106.  
  107. 
  108. File: pcl-cvs.info,  Node: Pcl-cvs installation,  Next: On-line manual installation,  Prev: Installation,  Up: Installation
  109.  
  110. Installation of the pcl-cvs program
  111. ===================================
  112.  
  113.   1. Possibly edit the file `Makefile' to reflect the situation at your
  114.      site.  We say "possibly" because the version of pcl-cvs included
  115.      with CVS uses a configuration mechanism integrated with the overall
  116.      mechanisms used by the CVS build and install procedures.  Thus the
  117.      file `Makefile' will be generated automatically from the file
  118.      `Makefile.in', and it should not be necessary to edit it further.
  119.  
  120.      If you do have to edit the `Makefile', the only things you have to
  121.      change is the definition of `lispdir' and `infodir'.  The elisp
  122.      files will be copied to `lispdir', and the info file(s) to
  123.      `infodir'.
  124.  
  125.   2. Configure pcl-cvs.el
  126.  
  127.      There are a couple of pathnames that you have to check to make
  128.      sure that they match your system.  They appear early in the file
  129.      `pcl-cvs.el'.
  130.  
  131.      *NOTE:*  If your system is running emacs 18.57 or earlier you MUST
  132.      uncomment the line that says:
  133.           (setq delete-exited-processes nil)
  134.  
  135.      Setting `delete-exited-processes' to `nil' works around a bug in
  136.      emacs that causes it to dump core.  The bug was fixed in emacs
  137.      18.58.
  138.  
  139.   3. Release 1.05 and later of pcl-cvs requires parts of the Elib
  140.      library, version 1.0 or later.  Elib is available via anonymous
  141.      ftp from prep.ai.mit.edu in `pub/gnu/elib-1.0.tar.gz', and from a
  142.      lot of other sites that mirror prep.  Get Elib, and install it,
  143.      before proceeding.
  144.  
  145.      *NOTE:* The version of pcl-cvs included with CVS includes a copy
  146.      of Elib in the sub-directory `elib' under the `contrib/pcl-cvs'
  147.      directory.
  148.  
  149.   4. Type `make install' in the source directory.  This will
  150.      byte-compile all `.el' files and copy the `*.elc' files into the
  151.      directory you specified in step 1.
  152.  
  153.      If you want to install the `*.el' files too, you can type `make
  154.      install-el' to do so.
  155.  
  156.      If you only want to create the compiled elisp files, but don't
  157.      want to install them, you can type `make' without parameters.
  158.  
  159.   5. Edit the file `default.el' in your emacs lisp directory (usually
  160.      `/usr/gnu/lib/emacs/site-lisp' or something similar) and enter the
  161.      contents of the file `pcl-cvs-startup.el' into it.  It contains a
  162.      couple of `auto-load's that facilitates the use of pcl-cvs.
  163.  
  164.  
  165. 
  166. File: pcl-cvs.info,  Node: On-line manual installation,  Next: Typeset manual installation,  Prev: Pcl-cvs installation,  Up: Installation
  167.  
  168. Installation of the on-line manual.
  169. ===================================
  170.  
  171.   1. Create the info file(s) `pcl-cvs.info*' from `pcl-cvs.texinfo' by
  172.      typing `make info'.  If you don't have the program `makeinfo' you
  173.      can get it by anonymous ftp from e.g. `prep.ai.mit.edu' as
  174.      `pub/gnu/texinfo-3.7.tar.gz' (there might be a newer version there
  175.      when you read this).
  176.  
  177.   2. Install the info file(s) `pcl-cvs.info*' into your standard `info'
  178.      directory.  You should be able to do this by typing `make
  179.      install-info'.
  180.  
  181.   3. Edit the file `dir' in the `info' directory and enter one line to
  182.      contain a pointer to the info file(s) `pcl-cvs.info*'.  The line
  183.      can, for instance, look like this:
  184.  
  185.           * Pcl-cvs: (pcl-cvs).           An Emacs front-end to CVS.
  186.  
  187. 
  188. File: pcl-cvs.info,  Node: Typeset manual installation,  Prev: On-line manual installation,  Up: Installation
  189.  
  190. How to make typeset documentation from pcl-cvs.texinfo
  191. ======================================================
  192.  
  193.    If you have TeX installed at your site, you can make a typeset manual
  194. from `pcl-cvs.texinfo'.
  195.  
  196.   1. Run TeX by typing ``make pcl-cvs.dvi''.  You will not get the
  197.      indices unless you have the `texindex' program.
  198.  
  199.   2. Convert the resulting device independent file `pcl-cvs.dvi' to a
  200.      form which your printer can output and print it.  If you have a
  201.      postscript printer there is a program, `dvi2ps', which does.  There
  202.      is also a program which comes together with TeX, `dvips', which
  203.      you can use.
  204.  
  205.  
  206. 
  207. File: pcl-cvs.info,  Node: About pcl-cvs,  Next: Getting started,  Prev: Installation,  Up: Top
  208.  
  209. About pcl-cvs
  210. *************
  211.  
  212.    Pcl-cvs is a front-end to CVS versions 1.5 through 1.7 and newer; and
  213. possibly verison 1.3 and 1.4A2.  It integrates the most frequently used
  214. CVS commands into an emacs interface.
  215.  
  216. * Menu:
  217.  
  218. * Contributors::                Contributors to pcl-cvs.
  219. * Archives::                    Where can I get a copy of Pcl-Cvs?
  220.  
  221. 
  222. File: pcl-cvs.info,  Node: Contributors,  Next: Archives,  Prev: About pcl-cvs,  Up: About pcl-cvs
  223.  
  224. Contributors to pcl-cvs
  225. =======================
  226.  
  227.    Contributions to the package are welcome.  I have limited time to
  228. work on this project, but I will gladly add any code that you
  229. contribute to me to this package (*note Bugs::.).
  230.  
  231.    The following persons have made contributions to pcl-cvs.
  232.  
  233.    * Brian Berliner wrote CVS, together with some other contributors.
  234.      Without his work on CVS this package would be useless...
  235.  
  236.    * Per Cederqvist wrote most of the otherwise unattributed functions
  237.      in pcl-cvs as well as all documentation.
  238.  
  239.    * Inge Wallin (`inge@lysator.liu.se') wrote the skeleton to
  240.      `pcl-cvs.texinfo', and gave useful comments on it.  He also wrote
  241.      the files `elib-node.el' and `compile-all.el'.  The file
  242.      `cookie.el' was inspired by Inge.
  243.  
  244.    * Linus Tolke (`linus@lysator.liu.se') contributed useful comments
  245.      on both the functionality and the documentation.
  246.  
  247.    * Jamie Zawinski (`jwz@lucid.com') contributed `pcl-cvs-lucid.el'.
  248.  
  249.    * Leif Lonnblad contributed RCVS support.  (Since superceded by the
  250.      new remote CVS support.)
  251.  
  252.    * Jim Blandy (`jimb@cyclic.com') contributed hooks to automatically
  253.      guess CVS log entries from ChangeLog contents; and initial support
  254.      of the new Cygnus / Cyclic remote CVS; as well as various sundry
  255.      bug fixes and cleanups.
  256.  
  257.    * Jim Kingdon (`kingdon@cyclic.com') contributed lots of fixes to
  258.      the build and install procedure.
  259.  
  260.    * Greg A. Woods (`woods@planix.com') contributed code to implement
  261.      the use of per-file diff buffers; and vendor join diffs with
  262.      emerge and ediff; as well as various an sundry bug fixes and
  263.      cleanups.
  264.  
  265.    Apart from these, a lot of people have send me suggestions, ideas,
  266. requests, bug reports and encouragement.  Thanks a lot!  Without your
  267. there would be no new releases of pcl-cvs.
  268.  
  269. 
  270. File: pcl-cvs.info,  Node: Archives,  Prev: Contributors,  Up: About pcl-cvs
  271.  
  272. Where can I get pcl-cvs?
  273. ========================
  274.  
  275.    The current release of pcl-cvs is included in CVS-1.7.
  276.  
  277.    The author's release of pcl-cvs can be fetched via anonymous ftp from
  278. `ftp.lysator.liu.se', (IP no. 130.236.254.1) in the directory
  279. `pub/emacs'.  If you don't live in Scandinavia you should probably
  280. check with archie to see if there is a site closer to you that archives
  281. pcl-cvs.
  282.  
  283.    New releases will be announced to appropriate newsgroups.  If you
  284. send your email address to me I will add you to my list of people to
  285. mail when I make a new release.
  286.  
  287. 
  288. File: pcl-cvs.info,  Node: Getting started,  Next: Buffer contents,  Prev: About pcl-cvs,  Up: Top
  289.  
  290. Getting started
  291. ***************
  292.  
  293.    This document assumes that you know what CVS is, and that you at
  294. least knows the fundamental concepts of CVS.  If that is not the case
  295. you should read the man page for CVS.
  296.  
  297.    Pcl-cvs is only useful once you have checked out a module.  So before
  298. you invoke it you must have a copy of a module somewhere in the file
  299. system.
  300.  
  301.    You invoke pcl-cvs by typing `M-x cvs-update RET'.  If your emacs
  302. responds with `[No match]' your system administrator has not installed
  303. pcl-cvs properly.  Try `M-x load-library RET pcl-cvs RET'.  If that
  304. also fails - talk to your root.  If it succeeds you might put this line
  305. in your `.emacs' file so that you don't have to type the `load-library'
  306. command every time you wish to use pcl-cvs:
  307.  
  308.      (autoload 'cvs-update "pcl-cvs" nil t)
  309.  
  310.    The function `cvs-update' will ask for a directory.  The command
  311. `cvs update' will be run in that directory.  (It should contain files
  312. that have been checked out from a CVS archive.)  The output from `cvs'
  313. will be parsed and presented in a table in a buffer called `*cvs*'.  It
  314. might look something like this:
  315.  
  316.      PCL-CVS release 1.05-CVS-1.7.
  317.      
  318.      In directory /users/ceder/FOO/test:
  319.        Updated     bar
  320.        Updated     file.txt
  321.        Modified ci namechange
  322.        Updated     newer
  323.      
  324.      In directory /users/ceder/FOO/test/sub:
  325.        Modified ci ChangeLog
  326.      ---------- End -----
  327.  
  328.    In this example the two files (`bar', `file.txt', and `newer') that
  329. are marked with `Updated' have been copied from the CVS repository to
  330. `/users/ceder/FOO/test/' since someone else have checked in newer
  331. versions of them.  Two files (`namechange' and `sub/ChangeLog') have
  332. been modified locally, and needs to be checked in.
  333.  
  334.    You can move the cursor up and down in the buffer with `C-n' and
  335. `C-p' or `n' and `p'.  If you press `c' on one of the `Modified' files
  336. that file will be checked in to the CVS repository.  *Note Committing
  337. changes::.  You can press `x' to get rid of the "uninteresting" files
  338. that have only been `Updated' (and don't require any further action
  339. from you).
  340.  
  341.    You can also easily get a `diff' between your modified file and the
  342. base version that you started from, and you can get the output from
  343. `cvs log' and `cvs status' on the listed files simply by pressing a key
  344. (*note Getting info about files::.).
  345.  
  346. 
  347. File: pcl-cvs.info,  Node: Buffer contents,  Next: Commands,  Prev: Getting started,  Up: Top
  348.  
  349. Buffer contents
  350. ***************
  351.  
  352.    The display contains four columns.  They contain, from left to right:
  353.  
  354.    * An asterisk when the file is "marked" (*note Selected files::.).
  355.  
  356.    * The status of the file.  See *Note File status::, for more
  357.      information.
  358.  
  359.    * A "need to be checked in"-marker (`ci').
  360.  
  361.    * The file name.
  362.  
  363. * Menu:
  364.  
  365. * File status::                 The meaning of the second field.
  366. * Selected files::              How selection works.
  367.  
  368. 
  369. File: pcl-cvs.info,  Node: File status,  Next: Selected files,  Prev: Buffer contents,  Up: Buffer contents
  370.  
  371. File status
  372. ===========
  373.  
  374.    The `file status' field can have the following values:
  375.  
  376. `Updated'
  377.      The file was brought up to date with respect to the repository.
  378.      This is done for any file that exists in the repository but not in
  379.      your source, and for files that you haven't changed but are not
  380.      the most recent versions available in the repository.
  381.  
  382. `Patched'
  383.      The file was brought up to date with respect to a remote
  384.      repository by way of fetching and applying a patch to the file in
  385.      your source.  This is done for any file that exists in a remote
  386.      repository and in your source; of which you haven't changed
  387.      locally but is not the most recent version available in the remote
  388.      repository.
  389.  
  390. `Modified'
  391.      The file is modified in  your  working  directory, and there was no
  392.      modification to the same file in the repository.
  393.  
  394. `Merged'
  395.      The file is modified in your working directory, and there were
  396.      modifications in the repository as well as in your copy, but they
  397.      were merged successfully, without conflict, in your working
  398.      directory.
  399.  
  400. `Conflict'
  401.      A conflict was detected while trying to merge your changes to FILE
  402.      with changes from the source repository.  FILE (the copy in your
  403.      working directory) is now the output of the `rcsmerge' command on
  404.      the two versions; an unmodified copy of your file is also in your
  405.      working directory, with the name `.#FILE.VERSION', where VERSION
  406.      is the RCS revision that your modified file started from.  *Note
  407.      Viewing differences::, for more details.
  408.  
  409. `Added'
  410.      The file has been added by you, but it still needs to be checked
  411.      in to the repository.
  412.  
  413. `Removed'
  414.      The file has been removed by you, but it needs to be checked in to
  415.      the repository.  You can resurrect it by typing `a' (*note Adding
  416.      and removing files::.).
  417.  
  418. `Unknown'
  419.      A file that was detected in your directory, but that neither
  420.      appears in the repository, nor is present on the list of files
  421.      that CVS should ignore.
  422.  
  423.    There are also a few special cases, that rarely occur, which have
  424. longer strings in the fields:
  425.  
  426. `Removed from repository'
  427.      The file has been removed from your directory since someone has
  428.      removed it from the repository.  (It is still present in the Attic
  429.      directory, so no permanent loss has occurred).  This, unlike the
  430.      other entries in this table, is not an error condition.
  431.  
  432. `Removed from repository, changed by you'
  433.      You have modified a file that someone have removed from the
  434.      repository.  You can correct this situation by removing the file
  435.      manually (see *note Adding and removing files::.).
  436.  
  437. `Removed by you, changed in repository'
  438.      You have removed a file, and before you committed the removal
  439.      someone committed a change to that file.  You could use `a' to
  440.      resurrect the file (see *note Adding and removing files::.).
  441.  
  442. `Move away FILE - it is in the way'
  443.      For some reason CVS does not like the file FILE.  Rename or remove
  444.      it.
  445.  
  446. `This repository is missing!  Remove this dir manually.'
  447.      It is impossible to remove a directory in the CVS repository in a
  448.      clean way.  Someone have tried to remove one, and CVS gets
  449.      confused.  Remove your copy of the directory.
  450.  
  451. 
  452. File: pcl-cvs.info,  Node: Selected files,  Prev: File status,  Up: Buffer contents
  453.  
  454. Selected files
  455. ==============
  456.  
  457.    Many of the commands works on the current set of "selected" files.
  458.  
  459.    * If there are any files that are marked they constitute the set of
  460.      selected files.
  461.  
  462.    * Otherwise, if the cursor points to a file, that file is the
  463.      selected file.
  464.  
  465.    * Otherwise, if the cursor points to a directory, all the files in
  466.      that directory that appears in the buffer are the selected files.
  467.  
  468.    This scheme might seem a little complicated, but once one get used to
  469. it, it is quite powerful.
  470.  
  471.    *Note Marking files:: tells how you mark and unmark files.
  472.  
  473. 
  474. File: pcl-cvs.info,  Node: Commands,  Next: Customization,  Prev: Buffer contents,  Up: Top
  475.  
  476. Commands
  477. ********
  478.  
  479.    The nodes in this menu contains explanations about all the commands
  480. that you can use in pcl-cvs.  They are grouped together by type.
  481.  
  482. * Menu:
  483.  
  484. * Updating the directory::      Commands to update the local directory
  485. * Movement commands::           How to move up and down in the buffer
  486. * Marking files::               How to mark files that other commands
  487.                                 will later operate on.
  488. * Committing changes::          Checking in your modifications to the
  489.                                 CVS repository.
  490. * Editing files::               Loading files into Emacs.
  491. * Getting info about files::    Display the log and status of files.
  492. * Adding and removing files::   Adding and removing files
  493. * Undoing changes::             Undoing changes
  494. * Removing handled entries::    Uninteresting lines can easily be removed.
  495. * Ignoring files::              Telling CVS to ignore generated files.
  496. * Viewing differences::         Commands to `diff' different versions.
  497. * Invoking Ediff::              Running `ediff' from `*cvs*' buffer.
  498. * Invoking Emerge::             Running `emerge' from `*cvs*' buffer.
  499. * Reverting your buffers::      Reverting your buffers
  500. * Miscellaneous commands::      Miscellaneous commands
  501.  
  502. 
  503. File: pcl-cvs.info,  Node: Updating the directory,  Next: Movement commands,  Prev: Commands,  Up: Commands
  504.  
  505. Updating the directory
  506. ======================
  507.  
  508. `M-x cvs-update'
  509.      Run a `cvs update' command.  You will be asked for the directory in
  510.      which the `cvs update' will be run.  The output will be parsed by
  511.      pcl-cvs, and the result printed in the `*cvs*' buffer (see *note
  512.      Buffer contents::. for a description of the contents).
  513.  
  514.      By default, `cvs-update' will descend recursively into
  515.      subdirectories.  You can avoid that behavior by giving a prefix
  516.      argument to it (e.g., by typing `C-u M-x cvs-update RET').
  517.  
  518.      All other commands in pcl-cvs requires that you have a `*cvs*'
  519.      buffer.  This is the command that you use to get one.
  520.  
  521.      CVS uses lock files in the repository to ensure the integrity of
  522.      the data files in the repository.  They might be left behind i.e.
  523.      if a workstation crashes in the middle of a CVS operation.  CVS
  524.      outputs a message when it is waiting for a lock file to go away.
  525.      Pcl-cvs will show the same message in the *cvs* buffer, together
  526.      with instructions for deleting the lock files.  You should
  527.      normally not have to delete them manually -- just wait a little
  528.      while and the problem should fix itself.  But if the lock files
  529.      doesn't disappear you can delete them with `M-x cvs-delete-lock
  530.      RET'.
  531.  
  532. `g'
  533.      This will run `cvs update' again.  It will always use the same
  534.      buffer that was used with the previous `cvs update'.  Give a prefix
  535.      argument to avoid descending into subdirectories.  This runs the
  536.      command `cvs-mode-update-no-prompt'.
  537.  
  538. `G'
  539.      This will run `cvs update' and prompt for a new directory to
  540.      update.  This runs the command `cvs-update'.
  541.  
  542. 
  543. File: pcl-cvs.info,  Node: Movement commands,  Next: Marking files,  Prev: Updating the directory,  Up: Commands
  544.  
  545. Movement Commands
  546. =================
  547.  
  548.    You can use most normal Emacs commands to move forward and backward
  549. in the buffer.  Some keys are rebound to functions that take advantage
  550. of the fact that the buffer is a pcl-cvs buffer:
  551.  
  552. `SPC'
  553. `C-n'
  554. `n'
  555.      These keys move the cursor one file forward, towards the end of the
  556.      buffer (`cookie-next-cookie').
  557.  
  558. `C-p'
  559. `p'
  560.      These keys move one file backward, towards the beginning of the
  561.      buffer (`cookie-previous-cookie').
  562.  
  563. 
  564. File: pcl-cvs.info,  Node: Marking files,  Next: Committing changes,  Prev: Movement commands,  Up: Commands
  565.  
  566. Marking files
  567. =============
  568.  
  569.    Pcl-cvs works on a set of "selected files" (*note Selected files::.).
  570. You can mark and unmark files with these commands:
  571.  
  572. `m'
  573.      This marks the file that the cursor is positioned on.  If the
  574.      cursor is positioned on a directory all files in that directory
  575.      will be marked.  (`cvs-mode-mark').
  576.  
  577. `u'
  578.      Unmark the file that the cursor is positioned on.  If the cursor
  579.      is on a directory, all files in that directory will be unmarked.
  580.      (`cvs-mode-unmark').
  581.  
  582. `M'
  583.      Mark *all* files in the buffer (`cvs-mode-mark-all-files').
  584.  
  585. `<ESC> <DEL>'
  586.      Unmark *all* files (`cvs-mode-unmark-all-files').
  587.  
  588. `<DEL>'
  589.      Unmark the file on the previous line, and move point to that line
  590.      (`cvs-mode-unmark-up').
  591.  
  592. 
  593. File: pcl-cvs.info,  Node: Committing changes,  Next: Editing files,  Prev: Marking files,  Up: Commands
  594.  
  595. Committing changes
  596. ==================
  597.  
  598. `c'
  599.      All files that have a "need to be checked in"-marker (*note Buffer
  600.      contents::.) can be checked in with the `c' command.  It checks in
  601.      all selected files (*note Selected files::.) (except those who
  602.      lack the "ci"-marker - they are ignored).  Pressing `c' causes
  603.      `cvs-mode-commit' to be run.
  604.  
  605.      When you press `c' you will get a buffer called
  606.      `*cvs-commit-message*'.  Enter the log message for the file(s) in
  607.      it.  When you are ready you should press `C-c C-c' to actually
  608.      commit the files (using `cvs-edit-done').
  609.  
  610.      Normally the `*cvs-commit-message*' buffer will retain the log
  611.      message from the previous commit, but if the variable
  612.      `cvs-erase-input-buffer' is set to a non-`nil' value the buffer
  613.      will be erased.  Point and mark will always be located around the
  614.      entire buffer so that you can easily erase it with `C-w'
  615.      (`kill-region').
  616.  
  617.      If you are editing the files in your emacs an automatic
  618.      `revert-buffer' will be performed.  (If the file contains `$Id$'
  619.      keywords `cvs commit' will write a new file with the new values
  620.      substituted.  The auto-revert makes sure that you get them into
  621.      your buffer).  The revert will not occur if you have modified your
  622.      buffer, or if `cvs-auto-revert-after-commit' is set to `nil'.
  623.  
  624. `C'
  625.      This is just like `cvs-mode-commit', except that it tries to
  626.      provide appropriate default log messages by looking at the
  627.      `ChangeLog's in the current directory.  The idea is to write your
  628.      ChangeLog entries first, and then use this command to commit your
  629.      changes.  Pressing `C' causes `cvs-mode-changelog-commit' to be
  630.      run.
  631.  
  632.      To select default log text, pcl-cvs:
  633.         - finds the ChangeLogs for the files to be checked in;
  634.  
  635.         - verifies that the top entry in the ChangeLog is on the
  636.           current date and by the current user; if not, no default text
  637.           is provided;
  638.  
  639.         - search the ChangeLog entry for paragraphs containing the
  640.           names of the files we're checking in; and finally
  641.  
  642.         - uses those paragraphs as the default log text in the
  643.           `*cvs-commit-message*' buffer.
  644.  
  645.      You can then commit the `ChangeLog' file once per day without any
  646.      log message.
  647.  
  648. 
  649. File: pcl-cvs.info,  Node: Editing files,  Next: Getting info about files,  Prev: Committing changes,  Up: Commands
  650.  
  651. Editing files
  652. =============
  653.  
  654.    There are currently three commands that can be used to find a file
  655. (that is, load it into a buffer and start editing it there).  These
  656. commands work on the line that the cursor is situated at.  They ignore
  657. any marked files.
  658.  
  659. `f'
  660.      Find the file that the cursor points to.  Run `dired' (*note
  661.      Dired: (Emacs)Dired.)  if the cursor points to a directory
  662.      (`cvs-mode-find-file').
  663.  
  664. `o'
  665.      Like `f', but use another window
  666.      (`cvs-mode-find-file-other-window').
  667.  
  668. `A'
  669.      Invoke `add-change-log-entry-other-window' to edit a `ChangeLog'
  670.      file.  The `ChangeLog' will be found in the directory of the file
  671.      the cursor points to.
  672.      (`cvs-mode-add-change-log-entry-other-window').
  673.  
  674. 
  675. File: pcl-cvs.info,  Node: Getting info about files,  Next: Adding and removing files,  Prev: Editing files,  Up: Commands
  676.  
  677. Getting info about files
  678. ========================
  679.  
  680.    Both of the following commands can be customized.  *Note
  681. Customization::.
  682.  
  683. `l'
  684.      Run `cvs log' on all selected files, and show the result in a
  685.      temporary buffer (`cvs-mode-log').
  686.  
  687. `s'
  688.      Run `cvs status' on all selected files, and show the result in a
  689.      temporary buffer (`cvs-mode-status').
  690.  
  691. 
  692. File: pcl-cvs.info,  Node: Adding and removing files,  Next: Undoing changes,  Prev: Getting info about files,  Up: Commands
  693.  
  694. Adding and removing files
  695. =========================
  696.  
  697.    The following commands are available to make it easy to add and
  698. remove files from the CVS repository.
  699.  
  700. `a'
  701.      Add all selected files.  This command can be used on `Unknown'
  702.      files (see *note File status::.).  The status of the file will
  703.      change to `Added', and you will have to use `c'
  704.      (`cvs-mode-commit', see *note Committing changes::.) to really add
  705.      the file to the repository.
  706.  
  707.      This command can also be used on `Removed' files (before you commit
  708.      them) to resurrect them.
  709.  
  710.      Selected files that are neither `Unknown' nor `Removed' will be
  711.      ignored by this command.
  712.  
  713.      The command that is run is `cvs-mode-add'.
  714.  
  715. `r'
  716.      This command removes the selected files (after prompting for
  717.      confirmation).  The files are `rm'ed from your directory and
  718.      (unless the status was `Unknown'; *note File status::.) they will
  719.      also be `cvs remove'd.  If the files were `Unknown' they will
  720.      disappear from the buffer.  Otherwise their status will change to
  721.      `Removed', and you must use `c' (`cvs-mode-commit', *note
  722.      Committing changes::.) to commit the removal.
  723.  
  724.      The command that is run is `cvs-mode-remove-file'.
  725.  
  726. 
  727. File: pcl-cvs.info,  Node: Undoing changes,  Next: Removing handled entries,  Prev: Adding and removing files,  Up: Commands
  728.  
  729. Undoing changes
  730. ===============
  731.  
  732. `U'
  733.      If you have modified a file, and for some reason decide that you
  734.      don't want to keep the changes, you can undo them with this
  735.      command.  It works by removing your working copy of the file and
  736.      then getting the latest version from the repository
  737.      (`cvs-mode-undo-local-changes'.
  738.  
  739. 
  740. File: pcl-cvs.info,  Node: Removing handled entries,  Next: Ignoring files,  Prev: Undoing changes,  Up: Commands
  741.  
  742. Removing handled entries
  743. ========================
  744.  
  745. `x'
  746.      This command allows you to remove all entries that you have
  747.      processed.  More specifically, the lines for `Updated' files
  748.      (*note File status::. and files that have been checked in (*note
  749.      Committing changes::.)  are removed from the buffer.  If a
  750.      directory becomes empty the heading for that directory is also
  751.      removed.  This makes it easier to get an overview of what needs to
  752.      be done.
  753.  
  754.      The command is called `cvs-mode-remove-handled'.  If
  755.      `cvs-auto-remove-handled' is set to non-`nil' this will
  756.      automatically be performed after every commit.
  757.  
  758. `C-k'
  759.      This command can be used for lines that `cvs-mode-remove-handled'
  760.      would not delete, but that you want to delete
  761.      (`cvs-mode-acknowledge').
  762.  
  763. 
  764. File: pcl-cvs.info,  Node: Ignoring files,  Next: Viewing differences,  Prev: Removing handled entries,  Up: Commands
  765.  
  766. Ignoring files
  767. ==============
  768.  
  769. `i'
  770.      Arrange so that CVS will ignore the selected files.  The file
  771.      names are added to the `.cvsignore' file in the corresponding
  772.      directory.  If the `.cvsignore' doesn't exist it will be created.
  773.  
  774.      The `.cvsignore' file should normally be added to the repository,
  775.      but you could ignore it also if you like it better that way.
  776.  
  777.      This runs `cvs-mode-ignore'.
  778.  
  779. 
  780. File: pcl-cvs.info,  Node: Viewing differences,  Next: Invoking Ediff,  Prev: Ignoring files,  Up: Commands
  781.  
  782. Viewing differences
  783. ===================
  784.  
  785. `d'
  786.      Display a `cvs diff' between the selected files and the RCS version
  787.      that they are based on.  *Note Customization:: describes how you
  788.      can send flags to `cvs diff'.  If CVS-DIFF-IGNORE-MARKS is set to a
  789.      non-`nil' value or if a prefix argument is given (but not both) any
  790.      marked files will not be considered to be selected.
  791.      (`cvs-mode-diff-cvs').
  792.  
  793. `b'
  794.      If CVS finds a conflict while merging two versions of a file
  795.      (during a `cvs update', *note Updating the directory::.) it will
  796.      save the original file in a file called `.#FILE.VERSION' where
  797.      FILE is the name of the file, and VERSION is the RCS version
  798.      number that your file was based on.
  799.  
  800.      With the `b' command you can run a `diff' on the files
  801.      `.#FILE.VERSION' and `FILE'.  You can get a context- or Unidiff by
  802.      setting `cvs-diff-flags' - *note Customization::..  This command
  803.      only works on files that have status `Conflict' or `Merged'.
  804.  
  805.      If CVS-DIFF-IGNORE-MARKS is set to a non-`nil' value or if a
  806.      prefix argument is given (but not both) any marked files will not
  807.      be considered to be selected.  (`cvs-mode-diff-backup').
  808.  
  809. 
  810. File: pcl-cvs.info,  Node: Invoking Ediff,  Next: Invoking Emerge,  Prev: Viewing differences,  Up: Commands
  811.  
  812. Running ediff
  813. =============
  814.  
  815. `e'
  816.      This command works slightly different depending on the version of
  817.      `ediff' and the file status.
  818.  
  819.      With modern versions of `ediff', this command invokes
  820.      `run-ediff-from-cvs-buffer' on one file.
  821.  
  822.      *Note:*  When the file status is `Merged' or `Conflict', CVS has
  823.      already performed a merge.  The resulting file is not used in any
  824.      way if you use this command.  If you use the `q' command inside
  825.      `ediff' (to successfully terminate a merge) the file that CVS
  826.      created will be overwritten.
  827.  
  828.      Older versions of `ediff' use an interface similar to `emerge'.
  829.      The function `cvs-old-ediff-interface' is invoked if the version
  830.      of `ediff' you have doesn't support `run-ediff-from-cvs-buffer'.
  831.      These older versions do not support merging of revisions.
  832.  
  833.     `Modified'
  834.           Run `ediff-files' with your working file as file A, and the
  835.           latest revision in the repository as file B.
  836.  
  837.     `Merged'
  838.     `Conflict'
  839.           Run `ediff-files3' with your working file (as it was prior to
  840.           your invocation of `cvs-update') as file A, the latest
  841.           revision in the repository as file B, and the revision that
  842.           you based your local modifications on as ancestor.
  843.  
  844.     `Updated'
  845.     `Patched'
  846.           Run `ediff-files' with your working file as file A, and a
  847.           given revision in the repository as file B.  You are prompted
  848.           for the revision to ediff against, and you may specify either
  849.           a tag name or a numerical revision number (*note Getting info
  850.           about files::.).
  851.  
  852. 
  853. File: pcl-cvs.info,  Node: Invoking Emerge,  Next: Reverting your buffers,  Prev: Invoking Ediff,  Up: Commands
  854.  
  855. Running emerge
  856. ==============
  857.  
  858. `E'
  859.      Invoke `emerge' on one file.  This command works slightly different
  860.      depending on the file status.
  861.  
  862.     `Modified'
  863.           Run `emerge-files' with your working file as file A, and the
  864.           latest revision in the repository as file B.
  865.  
  866.     `Merged'
  867.     `Conflict'
  868.           Run `emerge-files-with-ancestor' with your working file (as
  869.           it was prior to your invocation of `cvs-update') as file A,
  870.           the latest revision in the repository as file B, and the
  871.           revision that you based your local modifications on as
  872.           ancestor.
  873.  
  874.      *Note:*  When the file status is `Merged' or `Conflict', CVS has
  875.      already performed a merge.  The resulting file is not used in any
  876.      way if you use this command.  If you use the `q' command inside
  877.      `emerge' (to successfully terminate the merge) the file that CVS
  878.      created will be overwritten.
  879.  
  880. 
  881. File: pcl-cvs.info,  Node: Reverting your buffers,  Next: Miscellaneous commands,  Prev: Invoking Emerge,  Up: Commands
  882.  
  883. Reverting your buffers
  884. ======================
  885.  
  886. `R'
  887.      If you are editing (or just viewing) a file in a buffer, and that
  888.      file is changed by CVS during a `cvs-update', all you have to do
  889.      is type `R' in the *cvs* buffer to read in the new versions of the
  890.      files.
  891.  
  892.      All files that are `Updated', `Merged' or in `Conflict' are
  893.      reverted from the disk.  Any other files are ignored.  Only files
  894.      that you were already editing are read.
  895.  
  896.      An error is signalled if you have modified the buffer since it was
  897.      last changed.  (`cvs-mode-revert-updated-buffers').
  898.  
  899. 
  900. File: pcl-cvs.info,  Node: Miscellaneous commands,  Prev: Reverting your buffers,  Up: Commands
  901.  
  902. Miscellaneous commands
  903. ======================
  904.  
  905. `M-x cvs-byte-compile-files'
  906.      Byte compile all selected files that end in .el.
  907.  
  908. `M-x cvs-delete-lock'
  909.      This command can be used in any buffer, and deletes the lock files
  910.      that the *cvs* buffer informs you about.  You should normally
  911.      never have to use this command since CVS tries very carefully to
  912.      always remove the lock files itself.
  913.  
  914.      You can only use this command when a message in the *cvs* buffer
  915.      tells you so.  You should wait a while before using this command
  916.      in case someone else is running a cvs command.
  917.  
  918. `q'
  919.      Bury the *cvs* buffer.  (`bury-buffer').
  920.  
  921. 
  922. File: pcl-cvs.info,  Node: Customization,  Next: Future enhancements,  Prev: Commands,  Up: Top
  923.  
  924. Customization
  925. *************
  926.  
  927.    If you have an idea about any customization that would be handy but
  928. isn't present in this list, please tell me!  *Note Bugs:: for info on
  929. how to reach me.
  930.  
  931. `cvs-erase-input-buffer'
  932.      If set to anything else than `nil' the edit buffer will be erased
  933.      before you write the log message (*note Committing changes::.).
  934.  
  935. `cvs-inhibit-copyright-message'
  936.      The copyright message that is displayed on startup can be annoying
  937.      after a while.  Set this variable to `t' if you want to get rid of
  938.      it.  (But don't set this to `t' in the system defaults file - new
  939.      users should see this message at least once).
  940.  
  941. `cvs-diff-flags'
  942.      A list of strings to pass as arguments to the `cvs diff' and
  943.      `diff' programs.  This is used by `cvs-mode-diff-cvs' and
  944.      `cvs-mode-diff-backup' (key `b', *note Viewing differences::.).  If
  945.      you prefer the Unidiff format you could add this line to your
  946.      `.emacs' file:
  947.  
  948.           (setq cvs-diff-flags '("-u"))
  949.  
  950. `cvs-diff-ignore-marks'
  951.      If this variable is non-`nil' or if a prefix argument is given (but
  952.      not both) to `cvs-mode-diff-cvs' or `cvs-mode-diff-backup' marked
  953.      files are not considered selected.
  954.  
  955. `cvs-log-flags'
  956.      List of strings to send to `cvs log'.  Used by `cvs-mode-log' (key
  957.      `l', *note Getting info about files::.).
  958.  
  959. `cvs-status-flags'
  960.      List of strings to send to `cvs status'.  Used by `cvs-mode-status'
  961.      (key `s', *note Getting info about files::.).
  962.  
  963. `cvs-auto-remove-handled'
  964.      If this variable is set to any non-`nil' value
  965.      `cvs-mode-remove-handled' will be called every time you check in
  966.      files, after the check-in is ready.  *Note Removing handled
  967.      entries::.
  968.  
  969. `cvs-auto-revert-after-commit'
  970.      If this variable is set to any non-`nil' value any buffers you have
  971.      that visit a file that is committed will be automatically reverted.
  972.      This variable is default `t'.  *Note Committing changes::.
  973.  
  974. `cvs-update-prog-output-skip-regexp'
  975.      The `-u' flag in the `modules' file can be used to run a command
  976.      whenever a `cvs update' is performed (see cvs(5)).  This regexp is
  977.      used to search for the last line in that output.  It is normally
  978.      set to `"$"'.  That setting is only correct if the command outputs
  979.      nothing.  Note that pcl-cvs will get very confused if the command
  980.      outputs *anything* to `stderr'.
  981.  
  982. `cvs-cvsroot'
  983.      This variable can be set to override `CVSROOT'.  It should be a
  984.      string.  If it is set then everytime a cvs command is run it will
  985.      be called as `cvs -d CVS-CVSROOT...'  This can be useful if your
  986.      site has several repositories.
  987.  
  988. `TMPDIR'
  989.      Pcl-cvs uses this *environment variable* to decide where to put the
  990.      temporary files it needs.  It defaults to `/tmp' if it is not set.
  991.  
  992. `cvs-commit-buffer-require-final-newline'
  993.      When you enter a log message in the `*cvs-commit-message*' buffer
  994.      pcl-cvs will normally automatically insert a trailing newline,
  995.      unless there already is one.  This behavior can be controlled via
  996.      `cvs-commit-buffer-require-final-newline'.  If it is `t' (the
  997.      default behavior), a newline will always be appended.  If it is
  998.      `nil', newlines will never be appended.  Any other value causes
  999.      pcl-cvs to ask the user whenever there is no trailing newline in
  1000.      the commit message buffer.
  1001.  
  1002. `cvs-sort-ignore-file'
  1003.      If this variable is set to any non-`nil' value the `.cvsignore'
  1004.      will always be sorted whenever you use `cvs-mode-ignore' to add a
  1005.      file to it.  This option is on by default.
  1006.  
  1007. 
  1008. File: pcl-cvs.info,  Node: Future enhancements,  Next: Bugs,  Prev: Customization,  Up: Top
  1009.  
  1010. Future enhancements
  1011. *******************
  1012.  
  1013.    Pcl-cvs is still under development and needs a number of
  1014. enhancements to be called complete.  Below is my current wish-list for
  1015. future releases of pcl-cvs.  Please, let me know which of these
  1016. features you want most.  They are listed below in approximately the
  1017. order that I currently think I will implement them in.
  1018.  
  1019.    * Rewritten parser code.  There are many situations where pcl-cvs
  1020.      will fail to recognize the output from CVS.  The situation could
  1021.      be greatly increased.
  1022.  
  1023.    * `cvs-status'.  This will run `cvs status' in a directory and
  1024.      produce a buffer that looks pretty much like the current *cvs*
  1025.      buffer.  That buffer will include information for all
  1026.      version-controlled files.  (There will be a simple keystroke to
  1027.      remove all "uninteresting" files, that is, files that are
  1028.      "Up-to-date").  In this new buffer you will be able to update a
  1029.      file, commit a file, et c.  The big win with this is that you will
  1030.      be able to watch the differences between your current working file
  1031.      and the head revision in the repository before you update the
  1032.      file, and you can then choose to update it or let it wait for a
  1033.      while longer.
  1034.  
  1035.    * Log mode.  When this mode is finished you will be able to move
  1036.      around (using `n' and `p') between the revisions of a file, mark
  1037.      two of them, and run a diff between them.  You will be able to
  1038.      hide branches (similar to the way you can hide sub-paragraphs in
  1039.      outline-mode) and do merges between revisions.  Other ideas about
  1040.      this are welcome.
  1041.  
  1042.    * The current model for marks in the *cvs* buffer seems to be
  1043.      confusing.  I am considering to use the VM model instead, where
  1044.      marks are normally inactive.  To activate the mark, you issue a
  1045.      command like `cvs-mode-next-command-uses-marks'.  I might
  1046.      implement a flag so that you can use either version.  Feedback on
  1047.      this before I start coding it is very welcome.
  1048.  
  1049.    * It should be possible to run commands such as `cvs log', `cvs
  1050.      status' and `cvs commit' directly from a buffer containing a file,
  1051.      instead of having to `cvs-update'.  If the directory contains many
  1052.      files the `cvs-update' can take quite some time, especially on a
  1053.      slow machine.  I planed to put these kind of commands on the prefix
  1054.      `C-c C-v', but that turned out to be used by for instance c++-mode.
  1055.      If you have any suggestions for a better prefix key, please let me
  1056.      know.
  1057.  
  1058.    * Increased robustness.  For instance, you can not currently press
  1059.      `C-g' when you are entering the description of a file that you are
  1060.      adding without confusing pcl-cvs.
  1061.  
  1062.    * Support for multiple active *cvs* buffers.
  1063.  
  1064.    * Dired support.  I have an experimental `dired-cvs.el' that works
  1065.      together with CVS 1.2.  Unfortunately I wrote it on top of a
  1066.      non-standard `dired.el', so it must be rewritten.
  1067.  
  1068.    * An ability to send user-supplied options to all the cvs commands.
  1069.  
  1070.    * Pcl-cvs is not at all clever about what it should do when `cvs
  1071.      update' runs a program (due to the `-u' option in the `modules'
  1072.      file -- see `cvs(5)').  The current release uses a regexp to
  1073.      search for the end.  At the very least that regexp should be
  1074.      configured for different modules.  Tell me if you have any idea
  1075.      about what is the right thing to do.  In a perfect world the
  1076.      program should also be allowed to print to `stderr' without
  1077.      causing pcl-cvs to crash.
  1078.  
  1079.    If you miss something in this wish-list, let me know!  I don't
  1080. promise that I will write it, but I will at least try to coordinate the
  1081. efforts of making a good Emacs front end to CVS.  See *Note Bugs:: for
  1082. information about how to reach me.
  1083.  
  1084.    So far, I have written most of pcl-cvs in my all-to-rare spare time.
  1085. If you want pcl-cvs to be developed faster you can write a contract
  1086. with Signum Support to do the extension.  You can reach Signum Support
  1087. by email to `info@signum.se' or via mail to Signum Support AB, Box
  1088. 2044, S-580 02 Linkoping, Sweden.  Phone:  +46 (0) 13 - 21 46 00.  Fax:
  1089. +46 (0) 13 - 21 47 00.
  1090.  
  1091. 
  1092. File: pcl-cvs.info,  Node: Bugs,  Next: COPYING,  Prev: Future enhancements,  Up: Top
  1093.  
  1094. Bugs (known and unknown)
  1095. ************************
  1096.  
  1097.    If you find a bug or misfeature, don't hesitate to tell me!  Send
  1098. email to `ceder@lysator.liu.se'.
  1099.  
  1100.    If you have ideas for improvements, or if you have written some
  1101. extensions to this package, I would like to hear from you.  I hope that
  1102. you find this package useful!
  1103.  
  1104.    Below is a partial list of currently known problems with pcl-cvs
  1105. version 1.05.
  1106.  
  1107. Commit causes Emacs to hang
  1108.      Emacs waits for the `cvs commit' command to finish before you can
  1109.      do anything.  If you start a background job from the loginfo file
  1110.      you must take care that it closes `stdout' and `stderr' if you do
  1111.      not want to wait for it.  (You do that with `background-command &>-
  1112.      2&>- &' if you are starting `background-command' from a `/bin/sh'
  1113.      shell script).
  1114.  
  1115.      Your emacs will also hang if there was a lock file in the
  1116.      repository.  In this case you can type `C-g' to get control over
  1117.      your emacs again.
  1118.  
  1119. Name clash in Emacs 19
  1120.      This is really a bug in Elib or the Emacs 19 distribution.  Both
  1121.      Elib and Emacs 19.6 through at least 19.10 contains a file named
  1122.      `cookie.el'.  One of the files will have to be renamed, and we are
  1123.      currently negotiating about which of the files to rename.
  1124.  
  1125. Commands while cvs-update is running
  1126.      It is possible to type commands in the *cvs* buffer while the
  1127.      update is running, but error messages is all that you will get.
  1128.      The error messages should be better.
  1129.  
  1130. Unexpected output from CVS
  1131.      Unexpected output from CVS confuses pcl-cvs.  It will currently
  1132.      create a bug report that you can mail to me.  It should do
  1133.      something more civilized.
  1134.  
  1135. 
  1136. File: pcl-cvs.info,  Node: COPYING,  Next: Function and Variable Index,  Prev: Bugs,  Up: Top
  1137.  
  1138. GNU GENERAL PUBLIC LICENSE
  1139. **************************
  1140.  
  1141. 
  1142. File: pcl-cvs.info,  Node: Function and Variable Index,  Next: Concept Index,  Prev: COPYING,  Up: Top
  1143.  
  1144. Function and Variable Index
  1145. ***************************
  1146.  
  1147. * Menu:
  1148.  
  1149. * bury-buffer:                           Miscellaneous commands.
  1150. * cookie-next-cookie:                    Movement commands.
  1151. * cookie-previous-cookie:                Movement commands.
  1152. * cvs-auto-remove-handled (variable):    Customization.
  1153. * cvs-auto-revert-after-commit (variable) <1>: Customization.
  1154. * cvs-auto-revert-after-commit (variable): Committing changes.
  1155. * cvs-byte-compile-files:                Miscellaneous commands.
  1156. * cvs-commit-buffer-require-final-newline (variable): Customization.
  1157. * cvs-cvsroot (variable):                Customization.
  1158. * cvs-delete-lock:                       Updating the directory.
  1159. * cvs-diff-flags (variable):             Customization.
  1160. * cvs-diff-ignore-marks (variable) <1>:  Customization.
  1161. * cvs-diff-ignore-marks (variable):      Viewing differences.
  1162. * cvs-erase-input-buffer (variable) <1>: Customization.
  1163. * cvs-erase-input-buffer (variable):     Committing changes.
  1164. * cvs-inhibit-copyright-message (variable): Customization.
  1165. * cvs-log-flags (variable):              Customization.
  1166. * cvs-mode-acknowledge:                  Removing handled entries.
  1167. * cvs-mode-add:                          Adding and removing files.
  1168. * cvs-mode-add-change-log-entry-other-window: Editing files.
  1169. * cvs-mode-changelog-commit:             Committing changes.
  1170. * cvs-mode-commit:                       Committing changes.
  1171. * cvs-mode-diff-backup:                  Viewing differences.
  1172. * cvs-mode-diff-cvs:                     Viewing differences.
  1173. * cvs-mode-ediff:                        Invoking Ediff.
  1174. * cvs-mode-emerge:                       Invoking Emerge.
  1175. * cvs-mode-find-file:                    Editing files.
  1176. * cvs-mode-find-file-other-window:       Editing files.
  1177. * cvs-mode-ignore:                       Ignoring files.
  1178. * cvs-mode-log:                          Getting info about files.
  1179. * cvs-mode-mark:                         Marking files.
  1180. * cvs-mode-mark-all-files:               Marking files.
  1181. * cvs-mode-remove-file:                  Adding and removing files.
  1182. * cvs-mode-remove-handled:               Removing handled entries.
  1183. * cvs-mode-revert-updated-buffers:       Reverting your buffers.
  1184. * cvs-mode-status:                       Getting info about files.
  1185. * cvs-mode-undo-local-changes:           Undoing changes.
  1186. * cvs-mode-unmark:                       Marking files.
  1187. * cvs-mode-unmark-all-files:             Marking files.
  1188. * cvs-mode-unmark-up:                    Marking files.
  1189. * cvs-mode-update-no-prompt:             Updating the directory.
  1190. * cvs-old-ediff-interface:               Invoking Ediff.
  1191. * cvs-sort-ignore-file (variable):       Customization.
  1192. * cvs-status-flags (variable):           Customization.
  1193. * cvs-update:                            Updating the directory.
  1194. * cvs-update-prog-output-skip-regexp (variable): Customization.
  1195. * run-ediff-from-cvs-buffer:             Invoking Ediff.
  1196. * TMPDIR (environment variable):         Customization.
  1197.  
  1198. 
  1199. File: pcl-cvs.info,  Node: Concept Index,  Next: Key Index,  Prev: Function and Variable Index,  Up: Top
  1200.  
  1201. Concept Index
  1202. *************
  1203.  
  1204. * Menu:
  1205.  
  1206. * -u option in modules file:             Customization.
  1207. * .cvsignore file, sorting:              Customization.
  1208. * About pcl-cvs:                         About pcl-cvs.
  1209. * Active files:                          Selected files.
  1210. * Added (file status):                   File status.
  1211. * Adding files:                          Adding and removing files.
  1212. * Archives:                              Archives.
  1213. * Author, how to reach:                  Bugs.
  1214. * Authors:                               Contributors.
  1215. * Automatically inserting newline:       Customization.
  1216. * Automatically remove handled files:    Customization.
  1217. * Automatically sorting .cvsignore:      Customization.
  1218. * Buffer contents:                       Buffer contents.
  1219. * Bugs, how to report them:              Bugs.
  1220. * Bugs, known:                           Bugs.
  1221. * Byte compilation:                      Miscellaneous commands.
  1222. * Ci:                                    Committing changes.
  1223. * Commit buffer:                         Committing changes.
  1224. * Commit message, inserting newline:     Customization.
  1225. * Committing changes:                    Committing changes.
  1226. * Conflict (file status):                File status.
  1227. * Conflicts, how to resolve them:        Viewing differences.
  1228. * Conflicts, resolving <1>:              Invoking Emerge.
  1229. * Conflicts, resolving:                  Invoking Ediff.
  1230. * Context diff, how to get:              Customization.
  1231. * Contributors:                          Contributors.
  1232. * Copyright message, getting rid of it:  Customization.
  1233. * Customization:                         Customization.
  1234. * Deleting files:                        Adding and removing files.
  1235. * Diff:                                  Viewing differences.
  1236. * Dired:                                 Editing files.
  1237. * Ediff <1>:                             Invoking Emerge.
  1238. * Ediff <2>:                             Invoking Ediff.
  1239. * Ediff:                                 Viewing differences.
  1240. * Edit buffer:                           Committing changes.
  1241. * Editing files:                         Editing files.
  1242. * Email archives:                        Archives.
  1243. * Email to the author:                   Bugs.
  1244. * Emerge:                                Invoking Emerge.
  1245. * Enhancements:                          Future enhancements.
  1246. * Erasing commit message:                Committing changes.
  1247. * Erasing the input buffer:              Customization.
  1248. * Example run:                           Getting started.
  1249. * Expunging uninteresting entries:       Removing handled entries.
  1250. * FAQ:                                   Bugs.
  1251. * File selection:                        Selected files.
  1252. * File status:                           File status.
  1253. * Finding files:                         Editing files.
  1254. * Flush changes:                         Undoing changes.
  1255. * Ftp-sites:                             Archives.
  1256. * Generating a typeset manual:           Typeset manual installation.
  1257. * Generating the on-line manual:         On-line manual installation.
  1258. * Getting pcl-cvs:                       Archives.
  1259. * Getting rid of lock files:             Miscellaneous commands.
  1260. * Getting rid of the Copyright message.: Customization.
  1261. * Getting rid of uninteresting lines:    Removing handled entries.
  1262. * Getting status:                        Getting info about files.
  1263. * Getting the *cvs* buffer:              Updating the directory.
  1264. * Handled lines, removing them:          Removing handled entries.
  1265. * Info-file (how to generate):           On-line manual installation.
  1266. * Inhibiting the Copyright message.:     Customization.
  1267. * Installation:                          Installation.
  1268. * Installation of elisp files:           Pcl-cvs installation.
  1269. * Installation of on-line manual:        On-line manual installation.
  1270. * Installation of typeset manual:        Typeset manual installation.
  1271. * Introduction:                          Getting started.
  1272. * Invoking dired:                        Editing files.
  1273. * Invoking ediff <1>:                    Invoking Ediff.
  1274. * Invoking ediff:                        Viewing differences.
  1275. * Invoking emerge:                       Invoking Emerge.
  1276. * Known bugs:                            Bugs.
  1277. * Loading files:                         Editing files.
  1278. * Lock files:                            Miscellaneous commands.
  1279. * Log (RCS/cvs command):                 Getting info about files.
  1280. * Manual installation (on-line):         On-line manual installation.
  1281. * Manual installation (typeset):         Typeset manual installation.
  1282. * Marked files:                          Selected files.
  1283. * Marking files:                         Marking files.
  1284. * Merged (file status):                  File status.
  1285. * Modified (file status):                File status.
  1286. * Modules file (-u option):              Customization.
  1287. * Move away FILE - it is in the way (file status): File status.
  1288. * Movement Commands:                     Movement commands.
  1289. * On-line manual (how to generate):      On-line manual installation.
  1290. * Patched (file status):                 File status.
  1291. * Printing a manual:                     Typeset manual installation.
  1292. * Problems, list of common:              Bugs.
  1293. * Putting files under CVS control:       Adding and removing files.
  1294. * Recompiling elisp files:               Miscellaneous commands.
  1295. * Removed (file status):                 File status.
  1296. * Removed by you, changed in repository (file status): File status.
  1297. * Removed from repository (file status): File status.
  1298. * Removed from repository, changed by you (file status): File status.
  1299. * Removing files:                        Adding and removing files.
  1300. * Removing uninteresting (processed) lines: Removing handled entries.
  1301. * Reporting bugs and ideas:              Bugs.
  1302. * Require final newline:                 Customization.
  1303. * Resolving conflicts <1>:               Invoking Emerge.
  1304. * Resolving conflicts:                   Invoking Ediff.
  1305. * Resurrecting files:                    Adding and removing files.
  1306. * Reverting buffers:                     Reverting your buffers.
  1307. * Reverting buffers after commit <1>:    Customization.
  1308. * Reverting buffers after commit:        Committing changes.
  1309. * Selected files:                        Selected files.
  1310. * Selecting files (commands to mark files): Marking files.
  1311. * Sites:                                 Archives.
  1312. * Sorting the .cvsignore file:           Customization.
  1313. * Status (cvs command):                  Getting info about files.
  1314. * Syncing buffers:                       Reverting your buffers.
  1315. * TeX - generating a typeset manual:     Typeset manual installation.
  1316. * This repository is missing!... (file status): File status.
  1317. * Undo changes:                          Undoing changes.
  1318. * Unidiff, how to get:                   Customization.
  1319. * Uninteresting entries, getting rid of them: Removing handled entries.
  1320. * Unknown (file status):                 File status.
  1321. * Update program (-u option in modules file): Customization.
  1322. * Updated (file status):                 File status.
  1323. * Variables, list of all:                Customization.
  1324. * Viewing differences <1>:               Invoking Emerge.
  1325. * Viewing differences <2>:               Invoking Ediff.
  1326. * Viewing differences:                   Viewing differences.
  1327.  
  1328. 
  1329. File: pcl-cvs.info,  Node: Key Index,  Prev: Concept Index,  Up: Top
  1330.  
  1331. Key Index
  1332. *********
  1333.  
  1334. * Menu:
  1335.  
  1336. * a - add a file:                        Adding and removing files.
  1337. * A - add ChangeLog entry:               Editing files.
  1338. * b - diff backup file:                  Viewing differences.
  1339. * c - commit files:                      Committing changes.
  1340. * C - commit files with ChangeLog message: Committing changes.
  1341. * C-k - remove selected entries:         Removing handled entries.
  1342. * C-n - Move down one file:              Movement commands.
  1343. * C-p - Move up one file:                Movement commands.
  1344. * d - run cvs diff:                      Viewing differences.
  1345. * DEL - unmark previous file:            Marking files.
  1346. * e - invoke ediff:                      Invoking Ediff.
  1347. * E - invoke emerge:                     Invoking Emerge.
  1348. * ESC DEL - unmark all files:            Marking files.
  1349. * f - find file or directory:            Editing files.
  1350. * g - Rerun cvs update:                  Updating the directory.
  1351. * i - ignoring files:                    Ignoring files.
  1352. * l - run cvs log:                       Getting info about files.
  1353. * m - marking a file:                    Marking files.
  1354. * M - marking all files:                 Marking files.
  1355. * n - Move down one file:                Movement commands.
  1356. * o - find file in other window:         Editing files.
  1357. * p - Move up on file:                   Movement commands.
  1358. * q - bury the *cvs* buffer:             Miscellaneous commands.
  1359. * r - remove a file:                     Adding and removing files.
  1360. * R - revert buffers:                    Reverting your buffers.
  1361. * s - run cvs status:                    Getting info about files.
  1362. * SPC - Move down one file:              Movement commands.
  1363. * U - undo changes:                      Undoing changes.
  1364. * u - unmark a file:                     Marking files.
  1365. * x - remove processed entries:          Removing handled entries.
  1366.  
  1367.  
  1368. 
  1369. Tag Table:
  1370. Node: Top1024
  1371. Node: Installation3786
  1372. Node: Pcl-cvs installation4577
  1373. Node: On-line manual installation7055
  1374. Node: Typeset manual installation7983
  1375. Node: About pcl-cvs8727
  1376. Node: Contributors9173
  1377. Node: Archives11106
  1378. Node: Getting started11751
  1379. Node: Buffer contents14201
  1380. Node: File status14755
  1381. Node: Selected files18148
  1382. Node: Commands18821
  1383. Node: Updating the directory20165
  1384. Node: Movement commands21949
  1385. Node: Marking files22540
  1386. Node: Committing changes23408
  1387. Node: Editing files25821
  1388. Node: Getting info about files26672
  1389. Node: Adding and removing files27157
  1390. Node: Undoing changes28513
  1391. Node: Removing handled entries28978
  1392. Node: Ignoring files29902
  1393. Node: Viewing differences30437
  1394. Node: Invoking Ediff31753
  1395. Node: Invoking Emerge33473
  1396. Node: Reverting your buffers34510
  1397. Node: Miscellaneous commands35222
  1398. Node: Customization35970
  1399. Node: Future enhancements39648
  1400. Node: Bugs43851
  1401. Node: COPYING45617
  1402. Node: Function and Variable Index45769
  1403. Node: Concept Index48843
  1404. Node: Key Index56160
  1405. 
  1406. End Tag Table
  1407.